perm filename PFORM.ARR[UP,DOC]1 blob sn#456392 filedate 1979-07-11 generic text, type C, neo UTF8
COMMENT āŠ—   VALID 00004 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	PFORM is a pretty-printing program for PASCAL source files,
C00005 00003	<HOW TO USE IT>
C00007 00004	<SWITCHES>
C00016 ENDMK
CāŠ—;
PFORM is a pretty-printing program for PASCAL source files,
useful to reformat programs (indentation, upper-lower case)
and to find omitted or excessive BEGINS and ENDS.

comments, gripes and bugs to ARR.

<INPUT AND OUTPUT>
INPUT:
-----
through the file OLDSOURCE, a PASCAL source program file.

OUTPUT:
------
through the file NEWSOURCE:
	a copy of your input file, prettyprinted.
	(proper indentation according to the statement nesting,
	 newline on standard places in the program, management of upper
	 and lower case according to the list of reserved words, etc.)

By default, PFORM will change all reserved words and strings to upper
case, comments and everything else to lower case. There are switches 
available to change this condition.
<HOW TO USE IT>
You type:
	.R PFORM

Example:

	.r pform
	OLDSOURCE= myprog.pas/comm:u
	NEWSOURCE=   <CR>

The switches should be spelled correctly. This one asks for comments to
appear in lower case. The default for NEWSOURCE is myprog.new.

The program parameters all have default values, but they can be modified
if desired, by the use of switches. See the subtopic SWITCHES.
<SWITCHES>
					Brackets indicate optional.
   					<n> stands for an integer number.
   					<L> stands for a letter.

   Switch	   Meaning					Default.

        FILES.
/[NO]NEW        writting of the newsource file                 on

        PAGE AND LINE FORMAT
/INDENT:<n>     indentation between levels.                    4
     
        STATEMENT FORMAT
/BEGIN:[-]<n>   if the [-] is not there, the contents of a
                  begin..end block is indented n spaces further.
                if it is there, the block will not be indented,
                  but the begin and end statements will be
                  exdented n spaces.                           0
/[NO]FORCE      forces newline in standard places. (before and
                 after begin, end, then, else, repeat, etc.)   off
     
        UPPER AND LOWER CASE
                       note: the possible values for <l> are:
                               u means upper case
                               l means lower case.
     
/RES:<l>        case used for reserved words.                  u
/NONRES:<l>     same for non-reserved words.                   l
/COMM:<l>       same for comments.                             l
/STR:<l>        same for strings.                              u
/CASE:<l>       resets all the defaults to <l>.                        off